home *** CD-ROM | disk | FTP | other *** search
/ MacWorld Secrets (4th Edition) / Mac Secrets CD 4th Ed.toast / Shareware & Freeware / Add⁄Strip 3.3 / Add⁄Strip™ 3.3 Manual < prev    next >
Text File  |  1996-02-20  |  19KB  |  333 lines

  1. * Add/Strip™ 3.3 © 1987-96 by Jon Wind is Shareware ($25/copy or $100/site)
  2. * This file MUST accompany Add/Strip 3.3
  3. * Formatted using 12 point Times
  4.  
  5.  
  6. Files Included:
  7. ------------------------------------
  8.  
  9. ›  Add/Strip 3.3 ƒ - Contains Add/Strip 3.3 distribution files.
  10.     -  Add/Strip™ 3.3 - The main application.
  11.     -  Add/Strip™ 3.3 Docs - Basic documentation for this release.
  12.     -  A/S Help - Add/Strip online help resources.
  13.     -  A/S Balloon Help - Add/Strip Balloon Help resources.
  14.     -  Edit Add/Strip™ 3.3 - An application to edit Add/Strip 3.3 resources.
  15.  
  16.     ›  Example Files ƒ - Contains several demonstration TEXT files and processing settings files.
  17.         ›  About the Demos… - Brief explanation of contents of sample files’ folders.
  18.         ›  Database Demos ƒ - Contains demos of database file format conversions.
  19.         ›  HTML Convert ƒ - Contains demo of HTML code removal and conversion to RTF.
  20.         ›  Make Paragraphs ƒ - Contains demos of line to paragraph conversions.
  21.         ›  Sequential Replacements ƒ - Contains demos that illustrate ways to use replacements.
  22.  
  23.     ›  Remapping Sets ƒ - Contains additional remapping sets for installation using Edit Add/Strip.
  24.         -  Convert Diacriticals - Effectively removes diacritical marks (å to a, É to E, etc.).
  25.         -  Encrypt/Decrypt - Simple character replacement encryption and decryption.
  26.         -  Greek Maps - Examples of several foreign (Greek) character remapping sets.
  27.         -  Remove Numbers - Removes any and all number characters (0-9).
  28.  
  29.     ›  Utilities ƒ - Contains Tabs2BestVariable application.
  30.         -  Tabs2BestVariable 1.0.1 - Tab Delimited -> Variable process column with width scanning.
  31.         -  Tabs2BestVariable Docs - Brief documentation for Tabs2BestVariable application.
  32.         -  A/S Multi-set Processor - Sample AppleScript application for A/S.
  33.  
  34.  
  35. Description:
  36. ------------------------------------
  37.  
  38. TEXT documents created on a DOS-based machine or a mainframe are invariably formatted inappropriately for use on a Macintosh®.  They often contain unnecessary control characters, carriage returns, the wrong kind of quotation and apostrophe marks, and so forth.  Manually reformatting these documents can be a tedious and time-consuming task.
  39.  
  40. Add/Strip (A/S) has been designed to automatically perform much of the work of cleaning up TEXT files destined for import to page layout, word processing, database, or spreadsheet programs, as well as export from these programs to a DOS-based or mainframe computer.  All in a fraction of the time needed to manually reformat using a word processor.
  41.  
  42. Version 3.3 of A/S is the product of many hours of work, and is available as Shareware.  If you use it, please pay for it.  See the section entitled “Registration” for more.
  43.  
  44.  
  45. Commands:
  46. ------------------------------------
  47.  
  48. -->  See the online help (“About Add/Strip™…” menu item) for a more complete description of current functions and limitations.
  49.  
  50. -->  Please note that “Strip CRs” is NOT the same as “Make Paragraphs.”  If you plan on importing the text file to a page layout or word processing program you probably need to use “Make Paragraphs” or “Make Paragraphs2.”
  51.  
  52.  
  53. Order of Processing:
  54. ------------------------------------
  55.  
  56. Remap characters if required by chosen remapping set
  57. Replacement sets #1-225
  58. Line Replacement sets #1-125
  59. Strip control characters
  60. Make ellipses
  61. Make em dashes
  62. Make ligatures
  63. Leading string (done in main process if “Make Paragraphs” is chosen)
  64. Strip trailing spaces
  65. Quotes & apostrophes
  66. Normalize spaces
  67. Adjust case
  68. Perform main process
  69. Remap characters if required by chosen remapping set
  70.  
  71. BOF and EOF Insert Strings can be inserted into the text as it is read from the input file or they can be sent directly into the output file.  When the string is to be sent directly to the output file, A/S interprets any embedded ASCII character codes and, if the current character remapping set remaps outgoing characters, it remaps the characters as needed and sends the string to the output file.  No other processing is done.
  72.  
  73. When the string is to be inserted into the input text stream, A/S interprets any embedded ASCII character codes and then simply inserts the string into the input text as it is read from the input file.  The text is subjected to the same processing as the rest of the input file.
  74.  
  75.  
  76. Operating Tips:
  77. ------------------------------------
  78.  
  79. 1.  Read the online help CAREFULLY.
  80.  
  81. 2.  Don’t trash the original TEXT file until AFTER verifying that A/S has done what was expected.  The “Browse TEXT File…” option may be used to do this, though 10-25K can be displayed.
  82.  
  83. 3.  Be certain to verify ALL settings, including replacement strings, before processing a file.
  84.  
  85. 4.  Consider processing a file 2 or more times to achieve the desired effect.
  86.  
  87. 5.  Because replacements are made blindly, use a word processor to do conditional character replacement instead of A/S.
  88.  
  89. 6.  Hold down the option key when choosing the “File” menu to access the “Browse ANY File…” and “Process ANY File…” menu items.
  90.  
  91. 7.  Make the most commonly used settings the default values by choosing “Save as Default,” and/or save them as separate files.  Opening a settings file will open A/S, loading the values contained in that file.
  92.  
  93. 8.  Notify the author if you find a bug, or it may not get fixed.
  94.  
  95.  
  96. Registration:
  97. ------------------------------------
  98.  
  99. Add/Strip is Shareware.  This means that if you use it, you should pay for it.  It’s that simple.  I believe this a useful program at a reasonable price.  I hope you feel the same.  Please don’t rip me off.
  100.  
  101. Registering users receive a disk with the latest version (and a few other goodies), printed documentation, and may use future versions at no additional cost.  Registration is $25.  Site licenses, which allow for an unlimited number of copies to be used at a single location, are available for $100. Users who’ve already sent money and BBS operators may use this version free of charge.
  102.  
  103. CompuServe or ZiffNet users can register online quickly and easily!  From either, GO CIS:SWREG.  The Registration ID for Add/Strip is #5730; the site license version is #5731.  Since the registration fee is charged to your CompuServe account, this is a convenient way for foreign A/S users to register without the hassle of currency conversion.
  104.  
  105. If you choose to not register your copy, AT LEAST send comments, suggestions, and/or bug reports.  Be sure to let me know which version you’re using if you don’t use the printed registration form.  I can be reached at:
  106.  
  107. Jon Wind
  108. 2374 Hillwood Drive
  109. Maplewood, MN  55119
  110.  
  111. or
  112.  
  113. CompuServe:
  114.     70167,3444
  115.     jwind
  116.  
  117. Internet:
  118.     70167.3444@compuserve.com
  119.     jwind@compuserve.com
  120.  
  121.  
  122. Acknowledgments:
  123. ------------------------------------
  124.  
  125. Thanks are extended to those individuals who’ve bothered to send money and to those who’ve offered suggestions for improvements, especially my fearless beta testers.  This version of A/S could not have been created without your support.
  126.  
  127. A special thanks to Shane Stanley who allowed me to include his AppleScript application, A/S Multi-set Processor, and to Nicos Goulandris who created the Greek character remapping sets.
  128.  
  129.  
  130. Mandatory Disclaimer:
  131. ------------------------------------
  132.  
  133. A/S SHOULD work on Mac Pluses or better.  It works on the Macs I’ve tested it on, but I cannot guarantee that it will on yours.  If it doesn’t, please let me know and I’ll see what I can do to make it work.
  134.  
  135.  
  136. ====================================================
  137.  
  138.  
  139. Add/Strip 3.3 Changes:
  140. -----------------------------------------
  141.  
  142. Fixes:
  143.   •  Fixed bug that caused the last word in a chunk to be removed
  144.   •  Fixed bug that could cause character remapping to fail
  145.   •  Fixed problems preventing A/S from running on 68000-based Macs
  146.   •  Fixed bug that could prevent some option labels from printing when printing settings
  147.   •  Fixed Process Select window’s slider redrawing problems
  148.   •  Fixed column width list’s redrawing and highlighting problems
  149.   •  Fixed bug that prevented BOF and EOF strings from being inserted into all output files when processing folders
  150.   •  Fixed bug that added a space every 225 characters or so when processing long lines in some processes
  151.   •  Improved reliability of replacements containing “^@” codes, especially when in both Find and Change fields
  152.   •  Improved code used to open to the chosen Settings Folder when saving settings using System 7.5
  153.   •  Improved Space Runs -> Tab process to better deal with long lines
  154.   •  Improved accuracy of the file processing progress thermometer
  155.   •  Improved response to clicks in Replacements and Process Select windows
  156.  
  157. Changes:
  158.   •  Increased maximum number of spaces for Tabs -> Space Runs process from 50 to 100
  159.   •  Increased maximum number of replacements from 150 to 225 sets
  160.   •  Increased maximum number of line replacements from 50 to 125 sets
  161.   •  Increased replacements and line replacements speed
  162.   •  Line Replacements that search within lines now match all ocurrences in a line rather than just the first
  163.   •  Special pop-up menu removes disallowed codes rather than simply disabling them
  164.   •  Can no longer open A/S help from the help menu during file processing
  165.   •  If A/S is opened by dropping TEXT files and settings files on it, it no longer stays open after processing
  166.   •  Preferences files can now be opened directly from within A/S as though they were standard settings files
  167.   •  Updated online help, Balloon Help, and user guide (printed manual)
  168.  
  169. New:
  170.   •  Strings are inserted at the beginning or end of lines in line replacements by leaving the Find What string blank
  171.   •  Any chars wildcard codes (“^@”) can match any characters from the beginning or end of lines in line replacements so that “^@=” would match from the start of a line to the first “=” character or “=^@” could match from the last “=” character to the end of a line
  172.   •  Added sub-search code (“^:”) to specify a limited search domain and a sub-search string to use to perform searches within the specified domain so that “<PRE>^@</PRE>^:^p” would match all CRs contained in the character block starting with “<PRE>” and ending with “</PRE>”
  173.   •  BOF and EOF strings can be inserted into the input text stream, allowing replacements and other processes to act upon the strings
  174.   •  Supports copy and paste directly from and to the replacement and line replacement set lists; clipboard text is formatted as (and expected to be formatted as when pasting) Find What string, tab character, Change To string, carriage return; this format is repeated for each replacement set so that copying ten replacement sets places ten lines of text onto the clipboard
  175.   •  Added Preferences option to have A/S suggest DOS eight-dot-three file/folder names
  176.   •  Added option for Space Runs -> Tab process to evaluate leading spaces too
  177.   •  Added remapping sets to convert to and from the ISO Standard ISO8859-1 Latin-1 character codes
  178.  
  179.  
  180. Add/Strip 3.2.2 Changes:
  181. ------------------------------------
  182.  
  183.   •  Fixed bug that caused ^@ codes to fail to replace all matched characters
  184.   •  Fixed bug that caused ^? codes to fail in some line replacements
  185.   •  Command keys now work properly when the character chart window is open
  186.   •  Documents can no longer be opened when a replacements window is open
  187.   •  Added quick & dirty HTML code removal demo (I’m working on HTML to RTF conversion)
  188.  
  189.  
  190. Add/Strip 3.2.1 Changes:
  191. ------------------------------------
  192.  
  193.   •  Fixed bug that could cause A/S to quit with a system error when opening
  194.   •  Special pop-up menu now works in Characters Between Inserts window
  195.   •  Added three new wildcards; upper case, lower case, & punctuation characters
  196.   •  Added support for MS Word’s ^t and ^p character codes for tabs and CRs
  197.   •  Increased maximum width of replacement strings to 64 characters
  198.   •  Expanded alpha wildcard matches to include international characters
  199.   •  Fixed text coloring problem that could occur when command-typing characters
  200.   •  Fixed a bug that caused some “change to” ASCII codes to be ignored
  201.   •  Replacement lists show a case ignore checkbox for each set and always draw in plain text style
  202.   •  Divider line in replacements lists is movable to adjust cell width; double-click to center
  203.   •  Replace button replaces all selected replacement sets with the current Find/Change strings
  204.   •  Disable & Enable buttons dim if chosen items are already disabled/enabled
  205.   •  Force Width process no longer inserts bogus CRs when told to never merge lines
  206.   •  Remove bounding spaces option strips spaces from the beginning of lines too
  207.   •  Settings are now listed in processing order (more or less) in printouts
  208.   •  Improved word and sentence capitalization routines
  209.   •  New bevel effects and 3D buttons & checkboxes for monitors with 16 grays or 256+ colors
  210.   •  Added code for Now SuperBoomerang to add menus to Load Settings and Browse a File items
  211.   •  Made some minor code optimizations for Power PC
  212.   •  Removed a few lines of leftover debugging code
  213.   •  Updated the external help files
  214.  
  215.  
  216. New in Add/Strip 3.2:
  217. ------------------------------------
  218.  
  219. Fixes:
  220.   •  Merge All properly creates a file instead of a folder and processes
  221.   •  Process Select slider correctly adjusts after reading settings
  222.   •  Fixed pattern display in processing thermometer
  223.   •  Better support for processing very long lines
  224.   •  Better interaction between ASCII chart window and “parent” dialog
  225.   •  Improved reliability of replacement strings which ignore case
  226.   •  Improved feedback when dragging list items or list insertion point
  227.   •  Attempts to paste when a scrolling list is hilighted are now ignored
  228.   •  File chunks are now read to the nearest CR
  229.   •  Unreadable settings file no longer cancels opening of other D&D files in set
  230.   •  No more address errors when New Folder is chosen in Folder picker
  231.   •  No more bombs when loading settings files on 68000-based Macs
  232.   •  Processing of D&D files is prevented if currently processing a file
  233.   •  Improved handling of low memory situations
  234.  
  235. Changes:
  236.   •  New Finder icons
  237.   •  New Settings file format; A/S can read those created with 3.0 and later
  238.   •  Increased memory requirements but reduced memory fragmentation
  239.   •  Revised and added help text sections and Balloon Help balloons
  240.   •  Force Line Width process now breaks lines at spaces and tabs
  241.   •  ASCII Character codes use a “^” rather than a “#” before the number
  242.   •  Slider replaces scrollbar in Process Select window
  243.   •  Pop-up menus can be trigged by clicks in the title text
  244.   •  Replacement windows are movable and modal
  245.   •  Replacement windows use TrueType (when available) for full character set
  246.   •  Renamed “Filter noise chars” checkbox to “Strip control chars”
  247.   •  Process Select or Current settings window is hidden during processing
  248.   •  Desk Accessories can no longer be opened from A/S while processing
  249.   •  Quotes & Apostrophes curling is disabled for CSV -> Tab Delimited
  250.   •  Quits after processing if A/S was opened by TEXT file drag & drop
  251.   •  Dragged and dropped files are opened alphabetically, settings files first
  252.   •  TEXT file creator can be chosen by selecting a specific application
  253.   •  Aliases are shown when picking files, folders, and applications
  254.   •  More application preferences are available from hierarchical menu
  255.   •  A bunch of other odds and ends were adjusted as needed
  256.  
  257. New:
  258.   •  Colored windows with optional beveling
  259.   •  External files for topical help and Balloon Help
  260.   •  Current Settings mini-window in Process Only mode
  261.   •  Settings file name is shown in Process Select or Current settings window title
  262.   •  Command/option clicking in settings window title bar for settings popup menus
  263.   •  Line String Replacements Sets for replacing within a line & line removal
  264.   •  New types of searching wildcards (any digit, letter, or chars sequence)
  265.   •  Fixed String Insertions process to insert strings at fixed intervals
  266.   •  Variable String Insertions process to insert strings at variable intervals
  267.   •  Tab Delimited -> Variable2 process to convert to variable columnar
  268.   •  Mac to Unix and Unix to Mac remapping sets
  269.   •  Printing of most of the current settings
  270.   •  Revert Window menu item for appropriate windows
  271.   •  Select All command for edit text fields and replacement lists
  272.   •  Output file icon display in the save file window
  273.   •  Online help sections can be saved to TEXT files
  274.   •  Progress bar uses window colors (System 7.x) or hilight color (System 6.x)
  275.   •  Clicks on remapping set name in Process Select window picks new set
  276.   •  Up and down arrow keys adjust selected pairs in replacements list
  277.   •  Optional registration through CompuServe or ZiffNet (GO CIS:SWREG)
  278.  
  279.  
  280. Edit A/S 3.3 Changes:
  281. -----------------------------------------
  282.  
  283.   •  Remapping set names are forced to be unique - conflicting names are bad!
  284.   •  Fixed problem that could prevent aliases to copies of A/S from being opened
  285.   •  Changed Alpha Wildcard menu and window to Letter Wildcard
  286.   •  Can no longer remove 3D button resources from older versions of A/S
  287.  
  288.  
  289. New in Edit A/S 3.2.2:
  290. ------------------------------------
  291.  
  292.   •  Added capability to edit recent versions of Add/Strip (from 3.2)
  293.  
  294.  
  295. New in Edit A/S 3.2.1:
  296. ------------------------------------
  297.  
  298.   •  Fixed bug that could cause Edit A/S to quit with a system error when opening
  299.   •  Fixed bug that allowed Edit A/S to be chosen when importing remapping sets
  300.   •  Can edit match characters for alpha, digit, upper, lower, & punctuation wildcards
  301.   •  Windows are filled with a lighter gray
  302.   •  Made some minor code optimizations for Power PC
  303.   •  File open & save window color resources can be removed from A/S
  304.   •  3D buttons & checkboxes can be removed from A/S
  305.   •  Recognizes when the copy of A/S that is being edited is on a locked volume
  306.  
  307.  
  308. New in Edit A/S 3.2:
  309. ------------------------------------
  310.  
  311. Fixes:
  312.   •  Blocked importing of remapping sets from the open copy of A/S
  313.   •  Fixed bug which prevented some cursor sets from installing properly
  314.   •  Remapping sets import properly from other copies of A/S
  315.  
  316. Changes:
  317.   •  Revised Remove Resources window since help is now in external files
  318.   •  Characters can now be removed or remapped using remapping sets
  319.   •  CRs can be used in remapping sets when not translating immediately
  320.   •  Character charts use TrueType (if available) for full character set
  321.   •  A bunch of other odds and ends were adjusted as needed
  322.   •  Cursor installation can be limited to B&W versions only
  323.   •  Color cursors are drawn in color when not limiting to B&W versions
  324.  
  325. New:
  326.   •  New Finder icons
  327.   •  Application aliases are shown when opening a copy of A/S for editing
  328.   •  Variable sized remapping sets editor displays 9, 10, 12, 14, 18, 24 pt.
  329.   •  Creates remapping set files with support for import and export of sets
  330.   •  Current A/S user preferences can be made default preferences
  331.   •  Last installed cursor set is remembered
  332.   •  Created several remapping set files
  333.   •  More animated cursors, perhaps too many…